Your AI agent. One server. Any device. No baked-in behavior.
A coding assistant, a research agent, a personal automation — same binary, different configuration.
Get Started · Docs · GitHub
curl -fsSL https://jean2.ai/install.sh | bashjean2 init
jean2 startConnect a client:
npx @jean2/clientDesktop apps available for macOS, Windows, and iOS. See the setup guide for all options.
For development from source, see Contributing.
Connect any combination of LLM providers — OpenAI, Anthropic, Google, OpenRouter, or any OpenAI-compatible endpoint. Switch providers and models per-session. Budget models for routine tasks, premium for hard problems. No vendor lock-in.
Write tools in any runtime — Bun, Node, Python, Bash, Go, Rust, anything. A tool is just a directory with a manifest and a script. Drop it in, the agent picks it up. No build step, no registration.
Connect any MCP server (local or remote, with OAuth). Define Skills as discoverable SKILL.md instruction sets. Both are automatically available to your agent sessions.
Agents spawn hierarchical subagents for complex tasks. Isolated sessions, inherited workspace context, cascading interrupts. Configure depth limits per preconfig.
One persistent server. REST + WebSocket under the hood. Desktop, mobile, or browser — all connect the same way. Works over Tailscale, VPN, or local network.
System prompts, tools, and skills are all files on disk. Edit them, add them, remove them. Download preset bundles or build from nothing. Your agent, your rules.
| Use Case | Description |
|---|---|
| AI-Powered Coding | Connect Claude, GPT-5.4, or Gemini to your codebase. Subagents explore, refactor, and implement with full workspace isolation. |
| Research & Analysis | Give your agent tools to query APIs, scrape pages, and process documents. Isolated workspaces keep contexts separate. |
| Deployment & Ops | Connect MCP servers for Kubernetes, AWS, or Terraform. Multi-step deployment pipelines via subagent orchestration. |
| Automation Workflows | Create agent personalities for repetitive tasks. Skills let agents follow domain-specific workflows. Queue sessions for batch processing. |
A set of built-in tools to get started with jean2 init — or pick what you need and write your own in any language.
| Tool | Description |
|---|---|
| apply-patch | Apply unified diff patches to files atomically |
| edit | String replacements in files with fuzzy matching |
| glob | Find files matching glob patterns |
| read-file | Read files and directory listings |
| write-file | Write content to files |
| grep | Search files with regex patterns |
+9 more tools available · Explore all tools
Tools execute in sandboxed child processes. Define optional security checks for dangerous operations.
┌─────────────────────────────────────────────────────────────────┐
│ Client Layer │
│ ┌───────────┐ ┌──────────┐ ┌─────────────────────────┐ │
│ │ Desktop │ │ Mobile │ │ Web (npx @jean2/client) │ │
│ │ (Electron)│ │ (Tauri) │ │ │ │
│ └────┬──────┘ └────┬─────┘ └──────────┬──────────────┘ │
│ └──────────────┴─┬─────────────────┘ │
│ │ │
│ WebSocket + REST (any network) │
│ local · Tailscale · VPN · public │
└──────────────────────────┬──────────────────────────────────────┘
│
┌──────────────────────────┴─────────────────────────────────────┐
│ Server (@jean2/server) │
│ │
│ ┌─────────────┐ ┌──────────┐ ┌───────────────────┐ │
│ │ Agent Loop │ │ Tool │ │ MCP Manager │ │
│ │ (AI SDK v6) │ │ Executor │ │ (stdio + remote) │ │
│ └──────┬──────┘ └────┬─────┘ └────────┬──────────┘ │
│ └──────────────┼─────────────────┘ │
│ ┌────────┴───────────┐ │
│ │ ~/.jean2/tools/ │ │
│ │ (any runtime) │ │
│ └────────────────────┘ │
│ ┌──────────────┐ │
│ │ Subagent │ │
│ │ Orchestrator │ │
│ └──────┬───────┘ │
│ ┌────────────┴────────────┐ │
│ │ SQLite Store │ │
│ │ Sessions · Messages │ │
│ │ Permissions · History │ │
│ └─────────────────────────┘ │
│ │
│ Workspaces → directories on your machine │
└──────────────────────────┴─────────────────────────────────────┘
| Package | Description |
|---|---|
@jean2/server |
Agent loop, tool execution, REST + WebSocket API, SQLite, daemon mode |
@jean2/client |
React 19 + Vite 8 UI — chat, file browser, permissions, multi-server |
@jean2/sdk |
Shared TypeScript types, WebSocket protocol, transport layer, REST clients |
@jean2/client-electron |
Electron desktop app — macOS and Windows |
@jean2/client-tauri |
Tauri 2 native app — mobile (iOS, Android) |
| Layer | Technology |
|---|---|
| Runtime | Bun |
| Server | Hono, AI SDK v6, SQLite |
| Client | React 19, Vite 8, TypeScript |
| UI | Tailwind CSS v4, shadcn/ui, Radix UI |
| Desktop | Electron |
| Mobile | Tauri 2 |
| LLM | Vercel AI SDK v6, MCP SDK |
- Compact — LLM-powered conversation summarization
- Fork — Branch any session at any message
- Revert — Undo to any previous point
- Interrupt — Cancel generation with automatic cascade to subagents
- Queue — Queue messages while the agent is busy
- Remote Terminal — Full PTY terminal with multi-tab support
All configuration lives in ~/.jean2/ — model definitions, API keys, tools, preconfigs, and workspace data. See the configuration docs for the full reference.
